<datas> is an array of datas to be displayed as chart.
«chart type» is the chart type. It may be bar, column, pie, line, scatter or area. Default is column.
«window style» is a string defining the window style. Allowed styles are : plain, zoom, roundRect, rect, shadow, windoid, windoidZoom, bigWindoid, bigWindoidZoom, Rinaldoid, RinaldoidZoom (Rinaldoid is the same as windoid, except that it displays the window title). All window styles are floating, except plain, zoom and roundRect. A windoid or Rinaldoid style window will have small scrollbars, while other styles will use standard size. Default is RinaldoidZoom if Rinaldoid WDEF resource is present, windoidZoom if not found.
«X,Y[,Z,T]» will be a point or a rect, and will define position and/or size of the windoid. Coordinates are card-relative. If omitted, windoid will appear with standard size at "0,10".
«font name» is a string giving the font to use. Default is Geneva.
«font size» is a string giving the font size to use. Default is 10.
Using "!", "?" and "=" as first parameter will return an online help (resp. copyright, syntax and output).
USING
Chartoid is stand alone, no linked resource is needed. Meanwhile, this stack contains a WDEF resource that are recognized by the XCMD if present. The WDEF allows to have an enhanced, System 7 like windoid with title. So, this resource is optional, and for aesthetic purpose only. If you copy it, its ID can be set to any value but don't change its name.
Hint:
If you use a rect or shadow style window, placing it on a card can simulate a smart color graphic HyperCard field. In order to keep it at the same loc when the card window is moved, use the following script in stack:
on MoveWindow
set loc of window "My Chart" to "50,50"
end MoveWindow
With multiple screens configuration, the windoid will be zoomed on the screen where its largest part lays on.
Shortcut:
Control-Click in content allows to move the window (useful for rect or shadow type windows, since having no title bar).
MESSAGES
OpenChartoid : sent when a windoid is opened, followed by the windoid name and ID. This allows to define window properties before it is shown, since the message can be trapped using a handler :
on OpenChartoid WName,WId
if WName is "MyWindow" then...
end OpenChartoid
CloseChartoid : sent when a windoid is closed, followed by the windoid name and ID. This allows to get window properties before it is closed, since the message can be trapped using a handler :
on CloseChartoid WName,WId
if WName is "MyWindow" then...
end CloseChartoid
ClickInChartoid : sent when the user clicks on a value in the window, followed by the windoid name, ID, serie name, value name, serie #, value # and serie sum (except for pie, where last param is the value itself). The message can be trapped using a handler :
on ClickInChartoid WName,WId,sName,vName,sNb,vNv,val
if WName is "MyWindow" then...
end ClickInChartoid
COMMANDS
Chartoid supports 5 commands that will be called using :
send <command> to window <name>
print : displays the two print dialogs and prints the chart
printNoDialog : prints the chart using last setup.
copy : copies the chart to the clipboard.
save : brings a save dialog, and saves the chart as PICT file.
On return, the result contains the full path of saved
file.
saveNoDialog : saves the chart as PICT file using window name, in
the folder of current stack. On return, the result
contains the full path of saved file.
PROPERTIES
Like any XWindow, Chartoid has properties that can be get and set thru HyperTalk.
properties of window <name>
will return an item list of all allowed properties (default values are shown underlined) :
backColor : color of bkgnd (red, magenta, cyan, yellow,
blue, green, black, white or a 3 integer items
string giving the "red,green,blue" values)
backPattern : pattern of bkgnd (1-32)
backPixPat : pixPat of bkgnd (ppat resource name or id).
set to empty to dismiss it.
commands : list of supported commands
chartType : type of chart (column, pie, line, scatter, area,
bar)
framedLegend : boolean to set legend frame (true, false)
growAllowed : boolean to allow size change (true, false)
id : windoid's id (get only)
interval : percentage integer defining space between
columns (column chart only) (0-100)
legendLoc : legend's position (left, right, top, bottom)
loc : windoid's position according to card ("0,10")
messages : list of messages sent by the windoid
movedPart : pie's part number to move. 0 moves the largest.
Default is -1 (no moved part).
serie<N> : switch two series datas (set only)
(ex: set serie1 to 2)
serieColor<N> : color of serie N (red, magenta, cyan, yellow,
blue, green, black, white or a 3 integer items
string giving the "red,green,blue" values)
serieLine<N> : line size of serie N
serieName<N> : name of serie N
seriePattern<N> : pattern of serie N (1-32)
seriePict<N> : picture of serie N (PICT resource name or id)
seriePixPat<N> : pixPat of serie N (ppat resource name or id)
set to empty to dismiss it.
serieShape<N> : shape of serie N (rect,circle,diamond,triangle,
none) (line & scatter chart only)
seriesNb : number of series (get only)
serieValues<N> : values of serie N
showLegend : visibility of legend (true, false)
showLines : visibility of series lines (true, false)
showValues : visibility of series values (true, false)
showXGuides : visibility of vertical guides (true, false)
showXMarks : visibility of vertical marks (true, false)
showYGuides : visibility of horizontal guides (true, false)
showYMarks : visibility of vertical marks (true, false)
stacked : stacking of values (true, false)
superpose : percentage integer defining superposition of
columns (column chart only) (0-100)
textFont : font used for text drawing (Geneva, Times...)
textSize : font size used for text drawing (10)
threeDVal : 3D integer value (0)
valueColor<N> : color of value N (pie only) (red, magenta, cyan,
yellow, blue, green, black, white or a 3 integer
items string giving the "red,green,blue" values)
valueName<N> : name of value N (pie only)
valuePattern<N> : pattern of value N (pie only) (1-32)
valuePixPat<N> : pixPat of serie N (ppat resource name or id)
set to empty to dismiss it.
visible : visibility of windoid (true, false)
XTitle : X axis' title (empty)
YTitle : Y axis' title (empty)
ERRORS
If an error occurs, Chartoid can return :
"Error : Chartoid required Color QuickDraw"
"Error : empty parameter #X"
"Error : Window rect defined twice"
"Error : Window loc defined twice"
"Error : Font size defined twice"
"Error : Chart type defined twice"
"Error : Font name defined twice"
"Error : Unrecognized parameter #X"
"Error : Scatter chart requires almost 2 values series"
Free for non-commercial use. Use in commercial software subjected to prior acknowledgement and licensing from the author, reachable at the following network addresses:
/Chartoid 1.4 (US).rsrc/icl4_-16455.png){kind=link}